home *** CD-ROM | disk | FTP | other *** search
/ Acorn Risc Technologies StrongARM CD-ROM / Acorn Risc Technologies StrongARM CD-ROM.iso / ftp / documents / appnotes / 031_045 / 045c / Text
Encoding:
Text File  |  1993-08-02  |  6.0 KB  |  149 lines
  1. 5th August 1992
  2. -----------------------------------------------------------------------------
  3. Support Group Application Note 
  4. Number: 045 
  5. Issue: 2  
  6. Author: D J Bell
  7. -----------------------------------------------------------------------------
  8.  
  9. ADFS Application Note
  10.  
  11. -----------------------------------------------------------------------------
  12. Applicable Hardware: BBC Master Series
  13.  
  14. Related Application Notes:
  15.  
  16.  
  17. -----------------------------------------------------------------------------
  18. Copyright (C) Acorn Computers Limited 1992
  19.  
  20. Every effort has been made to ensure that the information in this leaflet is 
  21. true and correct at the time of printing. However, the products described in
  22. this leaflet are subject to continuous development and improvements and
  23. Acorn Computers Limited reserves the right to change its specifications at
  24. any time. Acorn Computers Limited cannot accept liability for any loss or
  25. damage arising from the use of any information or particulars in this
  26. leaflet. ACORN, ECONET and ARCHIMEDES are trademarks of Acorn Computers
  27. Limited.
  28. -----------------------------------------------------------------------------
  29. Support Group
  30. Acorn Computers Limited
  31. Acorn House
  32. Vision Park
  33. Histon
  34. Cambridge       CB4 4AE
  35. -----------------------------------------------------------------------------
  36.  
  37.  
  38. This Advanced Disc Filing System contains a hierarchical directory structure
  39. which is not compatible with the existing Disc Filing System.  The new
  40. filing system is, however, compatible with Winchester drives.  A Winchester
  41. drive may be used as one drive number and one or more floppy drives used as
  42. other drive numbers.
  43.  
  44. The filing system commands include:
  45.         *ACCESS <List spec> (E) (L) (W) (R) - Prevents accidental deletion
  46.         or erasure of files.
  47.         L - Lock,  R - Read,  W - Write,  E - Execute only.  D is a pseudo
  48.         variable set if the object <List spec> is a directory.  In this case
  49.         R and W have no meaning and are ignored.
  50.         Default states:         For a File W & R are set.
  51.                         For a directory D, L & R are set.
  52.  
  53.         *ADFS - starts ADFS from another filing system (A+BREAK is
  54.         equivalent).
  55.  
  56.         *BACK - Used to go back to the previously selected directory prior
  57.         to a *DIR or *BACK.
  58.  
  59.         *BYE - closes files and copies RAM buffer onto disc.
  60.  
  61.         *CDIR <Ob Spec> - creates a new directory with the name Ob Spec.
  62.  
  63.         *COMPACT <SP> <LP> - compacts information on a disc.  <SP> is the
  64.         Start Page of the memory area to be used whilst compacting and <LP>
  65.         is the length in pages of the memory. If none specified, current
  66.         screen used.
  67.  
  68.         *COPY <List Spec> <Ob Spec> - copies files defined by <List Spec>
  69.         into directory defined by <Ob Spec>.
  70.  
  71.         *DESTROY <List Spec> - deletes multiple objects.
  72.  
  73.         *DIR <Ob Spec> - to select a new Currently Selected Directory.  If
  74.         no <Ob Spec> is specified the root of the directory is selected.  At
  75.         start up Drive 0 and the Root directory are  automatically selected.
  76.  
  77.         *DISMOUNT (<Drive number>) - this command MUST be used before
  78.         exchanging discs in a drive.
  79.  
  80.         *FADFS - same a ADFS but starts with no directory ie no disc
  81.         start-up (F+BREAK is equiv).
  82.  
  83.         *FREE - displays free space left in sectors and bytes.
  84.  
  85.         *LCAT - catalogue the current library as in *CAT.
  86.  
  87.         *LEX - examine the current library as in *EX.
  88.  
  89.         *LIB <Ob Spec> - select the current library.
  90.  
  91.         *LOAD <Ob Spec> (<Load address>) - loads a file into memory at the
  92.         specified start address or, if not defined, at the file's own start
  93.         address.
  94.  
  95.         *MAP - display the free space map for the current drive.
  96.  
  97.         *MOUNT - initialises a disc.
  98.  
  99.         *OPT 1 (n) - this enables or disables the display of a file's
  100.         information each time a file is accessed on a disc.
  101.                 n = 1 to 99 to enable
  102.                 n = 0 to disable
  103.  
  104.         *OPT 4 (n) - changes the auto-start action, [SHIFT] and [BREAK], of
  105.         the disc in the currently selected drive.
  106.                 *OPT 4 0 does nothing
  107.                 *OPT 4 1 will *LOAD the file !BOOT
  108.                 *OPT 4 2 will *RUN the file !BOOT
  109.                 *OPT 4 3 will *EXEC the file !BOOT
  110.  
  111.         *REMOVE <Ob Spec> - same as *DELETE except that no error message is
  112.         produced if the object does not exist.
  113.  
  114.         *RENAME <Ob Spec> <Ob Spec> - renames an object and moves it to
  115.         another directory if required.
  116.  
  117.         *RUN <Ob Spec> <Optional parameters> - this command loads a file
  118.         into memory and then jumps to its execution address, unless the
  119.         execution address is FFFFFFFF when the file is EXEC'd as a text
  120.         file.
  121.  
  122.         *SAVE <Ob Spec> <Start addr> <Fin addr> (<Exe addr>) (<Reload addr>)
  123.         - saves an area of memory, typically a machine code program, into a
  124.         file on the disc.  A maximum of 47 objects can be held in a
  125.         directory.
  126.  
  127.         *SPOOL <Ob Spec> - opens the named file, and spools subsequent
  128.         screen output to that file and closes the file when terminated with
  129.         *SPOOL (cr).
  130.  
  131.         *TITLE <Title> - changes the title of the currently selected
  132.         directory (a maximum of 19 characters are allowed).
  133.  
  134. NOTE:  See MOS spec for other common filing system commands.
  135.  
  136. The following calls are relevant for accessing files from assembly language:
  137.         OSFIND - Opens a file for reading/writing update
  138.         OSFILE - Load/Save data.  Enquire after/Alter catalogue information.
  139.         OSARGS - Reads/Writes an open file's attributes.
  140.         OSGBPB - Write/Read a group of bytes to/from a specified open file.
  141.         OSBGET - Gets a byte from a specified open file.
  142.         OSBPUT - Puts a byte to a specified open file.
  143.  
  144. Four OSWORD calls are recognised by ADFS:
  145.         OSWORD with A=&70 - Read master sequence number and status byte.
  146.         OSWORD with A=&71 - Read free space.
  147.         OSWORD with A=&72 -  Access disc controller.
  148.         OSWORD with A=&73 - Read last error information.
  149.